Fixing Markdown’s shortcomings with Python

A new take on using Markdown for technical documentation.

Markdown has become the go-to lightweight markup language for a variety of tasks — you’ll find it powering commenting systems, blogs, wikis, and static websites of all sorts. This widespread adoption has led to a number of advantages over other markup languages — namely, AsciiDoc and reStructuredText — when it comes to writing technical documentation:

Note: When I refer to “AsciiDoc,” I’m talking about the variation of the syntax…